home *** CD-ROM | disk | FTP | other *** search
/ SPACE 1 / SPACE - Library 1 - Volume 1.iso / telecomm / 127 / starnet.doc < prev    next >
Text File  |  1988-02-05  |  24KB  |  572 lines
  1. Registering for Updates:
  2.  
  3. For $35.00 You can download all updates from my BBS or for $50.00 you can
  4. get the disks and Docs mailed to you all updates after the initial cost can
  5. be downloaded free or sent to you by mail for $10.00. Version 1.30 is the 
  6. current version for registered sysops,this includes FIDONET compatable 
  7. networking. Plus much more.... Why pay more????????
  8. Eric Drewry
  9. 15 Greenlawn Ave
  10. South Grafton Ma 01560
  11. 617-839-5810 8pm -9am EST BBS Otherwise call voice.
  12.    Installing STar-Net
  13.    -------------------
  14.  
  15.    1. Backup this disk.
  16.    2. Run CONFIG.TOS
  17.    Editing access levels
  18.    There are 16 access level 0-15.When you choose the edit access level option
  19.    you are prompted for an access level to edit.You can the change calls per
  20.    day,time per call,idle time(amount of time the BBS will wait before hanging
  21.    up on a user who isnt doing anything),their ability to enter E-Mail,play
  22.    outside games,access the system maint.(sysop mode),entering news,and 
  23.    maintaining the new,G-files and programs areas.
  24.  
  25.    Editing Message Bases
  26.    There are 20 message bases 1-20.When you choose edit message base option
  27.    you are prompted for the message base to access.You can change the message
  28.    base name,pathname(where the BBS stores the message base on you disk system)
  29.    the minimum access level that can access the message base,the maximum
  30.    number of messages allowed,and the Subop(a subop is a user who has sysop
  31.    access only on that message base).
  32.  
  33.    Editing UD sections
  34.    There are 20 UD sections.All options are the same as the message bases
  35.    except the options that refer to message numbers.
  36.  
  37.    Editing other parameters
  38.    Edit default pathname
  39.       This is the path where the user.dat,user.ver files should be placed.
  40.    It should remain in the root directory of any of your drives(ie a:\  b:\)
  41.    .If you are using the log to disk option the star.log file is created here.
  42.  
  43.    Edit mail pathname
  44.       This is the pathname where the mail is kept.You must create this
  45.    folder for the BBS to save its mail correctly.
  46.  
  47.    Edit outside pathname
  48.       This is the pathname where your outside games,msh.prg are kept.
  49.    Also place a copy of arc.ttp there.You must creat this folder and copy these
  50.    files into it for the BBS to handle the outside games a V option from the UD
  51.    section properly.
  52.  
  53.    Edit textfile pathname
  54.       This is the pathname that the BBS looks for the menu,welcome,newuser
  55.    logon and logoff textfiles and graphics files.You must these files to a new
  56.    folder with that name.
  57.  
  58.    Edit BBS name
  59.       This name will be displayed in the welcome prompt before asking
  60.    if you have a VT52 terminal or for you to press return in the hayes result
  61.    code method of baud rate detect.
  62.  
  63.    Edit Chat mode engage string
  64.       This string will be sent to the user and screen when you enter chat
  65.    mode.
  66.  
  67.    Edit return from chat string
  68.       This string will be displayed when you return the BBS to user control.
  69.  
  70.    Edit # of calls to system
  71.       This allow you to change the total of calls the system thinks it has 
  72.    received.
  73.  
  74.    Toggle Baud Rate detection type
  75.       This allows you to change from the hayes result code method of 
  76.    determining the callers baud rate to the hit return method and visa-versa.
  77.    If you think you hayes compatable modem is having trouble determining the 
  78.    baud rate change this.
  79.  
  80.    Edit system ID string
  81.       This allows you to change the 2 character string that precedes the 
  82.    users ID number for your system.
  83.  
  84.    Edit new user starting points
  85.       This allows you to determine how many points a new user will start 
  86.    off with.
  87.  
  88.    Toggle system log
  89.       This allows you to send the feedback and system caller messages to
  90.    either the disk or printer.
  91.  
  92.    Toggle part time BBS
  93.       This allows you to set a time the BBS will go on and off.You can
  94.    have it be off for as little as 1 minute.At the time the BBS goes off it
  95.    will look in the folder that the main program is in for a program
  96.    called shell.prg.You can name any shell such as STSHELL(from Computes ST)
  97.    shell.prg and create a autolog.bat file that will run other programs that
  98.    exit by itself(such as the Maintainance program for the online game space
  99.    empire) you could also use it to back up your user list or things like
  100.    that.
  101.   
  102.    Edit news pathname
  103.       This is the pathname where the news is kept.You must create this
  104.    folder for the BBS to save its news correctly.
  105.  
  106.    Ending config.tos
  107.       Make sure you save the configuration with the B command before  
  108.    exiting the program. 
  109.  
  110.    Bootstar.prg
  111.       This is the program that boots Star-Net from an auto folder. If you
  112.    have a hard drive on this system it is probably C:\AUTO\ otherwise it 
  113.    would be A:\AUTO\. Place this program in your auto folder. The file 
  114.    bootstar.con contains the path name to where the main program starv12.prg
  115.    is to be kept, this can be any folder on any drive other than the root
  116.    directory (example A:\STAR\). This file can be edited using any editor 
  117.    such as EMACS or First Word with the word processing mode turned off.
  118.    Place Bootstar.con in the root directory of your drive with the auto
  119.    folder. 
  120.  
  121.    Star.con
  122.       This file holds the sytem configuration data, it should be
  123.    placed in the same folder as starv12.prg. This folder should also
  124.    contain config.tos.
  125.  
  126.    User.ver and User.dat 
  127.       These files hold your user information, they should be placed
  128.    in the root directory (the drive entered in config.tos as default path).
  129.    If for some reason the system cannot find these files, a message will be
  130.    sent to the screen telling you where it is trying to find them.
  131.  
  132.    Msh.prg
  133.       This file executes the online games and arc.ttp. It should be
  134.    placed in the folder entered in config.tos as the outside path. 
  135.    NOTE: This program will bomb if executed from the desktop.
  136.  
  137.    Arc.ttp
  138.       This file is not supplied, it is an archive utility in the public
  139.    domain available on most BBS's. This file should be placed in the outside
  140.    path. 
  141.  
  142.    Shell.prg
  143.       This file is not supplied, you can rename a shell prg such as
  144.    STSHELL.PRG from COMPUTE'S ST that support a batch file that auto executes
  145.    on entry to the program. If you choose the part-time BBS option from
  146.    config.tos the BBS will execute this program when the BBS is shut down.
  147.    If you wish to use this option and you are operating a 24 hr. BBS you
  148.    can still choose part-time BBS and only have the time shut down be the
  149.    estimated time that your batch file will take to complete. This should be
  150.    placed in the same folder as starv12.prg.
  151.  
  152.    Quotes.bbs
  153.       This file should be placed in the same folder as starv12.prg.
  154.    This is a text file of quotes seperated by 2 carriage return line feeds.
  155.    You can edit it with First Word or EMACS. One of the quotes will be
  156.    displayed to the user just before they reach the main prompt. 
  157.  
  158.    Text (.txt) graphics (.gra) 
  159.       Files with the .txt extension have a .gra counterpart. The .txt
  160.    extension is for files with standard ascii text. The .gra extension is for
  161.    files with VT52 control codes. 
  162.    EXAMPLES:   welcome.txt    welcome.gra
  163.                newuser.txt    newuser.gra
  164.                logon.txt      logon.gra
  165.                logoff.txt     logoff.gra
  166.                menu1.txt      menu1.gra
  167.                .               .
  168.                .               .
  169.                .               .
  170.                menu9.txt      menu9.gra
  171.    These files should be placed in the folder entered in config.tos as the
  172.    path for text files. 
  173.  
  174.    Modemcom.txt
  175.       This file should be placed in the folder entered in config.tos
  176.    as the path for text files. This is an exception to the above .txt .gra
  177.    comparison. This file contains the command string to be sent to the
  178.    modem to enable auto answer and change the result codes to extended 
  179.    numerical results. You can change this command string with the standard
  180.    editors to suit your own modem.
  181.  
  182.    Userconv.tos
  183.       This file is used to convert a userlog(the user.dat and user.ver
  184.    files) from versions lower than .09 to the new format.It will 2 new files
  185.    with the .ver and .dat extensions.Place userconv.tos in the same folder
  186.    as user.dat and user.ver and run userconv.tos.Scratch user.dat and user.ver
  187.    and rename the new files to user.ver and user.dat.
  188.  
  189.    Booting the system
  190.       STar-Net will autoboot after a system reset or on powerup.
  191.  
  192.    Setting the time
  193.       The keyboard clock is read on bootup and the TOS clock is set to
  194.    the time of the keyboard clock. So you can set the time from Control.ACC
  195.    if you wish,or when the waiting for call screen comes up you can set the
  196.    time using F4.The time should be entered in 24 hour format(ie midnight is
  197.    00:00 and 1:00 PM is 13:00).
  198.  
  199.    First time logon
  200.       You enter the BBS in local mode by pressing F1. You will then be asked
  201.    weither you terminal supports VT52 graphics.If 'yes' the system will
  202.    try to read the VT52 graphic menus and text file(.GRA) instead of the 
  203.    ASCII files (.TXT). If you have not created VT52 graphics files a message 
  204.    will come on the screen saying the file cannot be opened(this message is not
  205.    sent to the modem) and the ASCII file will be read. You next prompt is
  206.    a press return prompt.If you press return at the prompt the file welcome.txt
  207.    will be read,although if you enter an 'a' then press return that file
  208.    will be aborted.You will then be prompted for your user ID.As you have not 
  209.    been on before enter 'NEW'.The NEWUSER file will then be read.You will then 
  210.    be asked information about yourself. When you have completed the new user
  211.    information you will be brought back to the prompt for your user ID. You
  212.    can enter the ID number or your handle here. You will then be prompted for
  213.    your password. This completes the logon procedure.
  214.  
  215.    Raising your access:
  216.       To raise your access you can either use F3 (this enters system
  217.    maintenance without modem I/O turned off), or F5 (this enters system 
  218.    maintenance with modem I/O turned off). Once  you are in SM you will get
  219.    a prompt showing the active drive and path name. To edit your user account
  220.    type "user", you will then be asked for the type of search for users. To 
  221.    edit your own access enter 'C' for current user. You can now edit your user 
  222.    information. To change your access level, type 'A',you will then be prompted
  223.    for what access level you wish, enter 15 which is sysop level. To return to
  224.    the BBS type Q at the next prompt type Q again and then type exit, and then 
  225.    you will be returned to the main menu. 
  226.  
  227.  
  228.    Adding outside programs:
  229.       Copy the program and all files associated with it to the folder
  230.    named in config.tos as the outside path. Log on to the BBS and from the
  231.    main menu enter'P'and'A',you will then be prompted for the title name of the
  232.    program, followed by the file name, any parameters to be passed to the file,
  233.    access level,and whether the file needs I/O redirection. Now the addition of
  234.    the outside program should be complete. 
  235.  
  236.    Adding News:
  237.       Follow the same procedure as adding outside programs except for 
  238.    the copying, and entering 'N' instead of 'P',you will then be put into the
  239.    editor to enter your news.
  240.  
  241.    Adding General Files:
  242.       Follow the same procedure as adding outside programs except for
  243.    entering 'G' instead of 'P', and the files should be copied to the folder
  244.    entered in config.tos as the folder for text  files.
  245.  
  246.    Adding Program to the UD Section:
  247.       Copy the files into the folder entered in config.tos as the folder
  248.    for the UD section you want to add the program to. Log on to the BBS
  249.    enter UD at the main prompt, type the number of the UD section you want to
  250.    add the file to, type 'A', you will then be prompted for the file name.
  251.    After you have entered the file name the BBS will find the file on the disk
  252.    ,display the file size and prompt you for a description. 
  253.  
  254.    Editing Text Files:
  255.       Log on to the BBS, enter SM at the main prompt, enter 'edit' .
  256.    You will then be prompted for the file name. The file will then be loaded
  257.    into the editor, press return once, you can now use the editors commands to
  258.    edit the file.
  259.  
  260.    Possible Problems:
  261.       I have had a number of calls from people with the problem of the 
  262.    BBS going into a loop of sending the modem command string. If you are
  263.    having this problem you should check the switch setting of your modem.
  264.    Most Hayes Compatible modems have switches that control weither the modem
  265.    will respond to carrier detect,if this swich is set to force carrier detect
  266.    high the BBS will asways see a carrier and never get to the waiting for
  267.    call screen.There is also another switch that controls weither the modem
  268.    will respond to terminal ready if this switch is set to force terminal 
  269.    ready high the modem will not hang up when terminal ready is brought low
  270.    by the BBS.
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.    STar-Net Docs
  283.    -------------
  284.  
  285.    First The files config.tos, star.con must be in the same folder.
  286.    for  editing  the  configuration,it  is  not  needed  for   normal 
  287.    operation  of  the  program so it can  be  copied  there  whenever 
  288.    needed.Starv12.prg  can  be  kept  in any  folder  except  a  root 
  289.    directory,the file star.con should be kept in the same folder.This 
  290.    program  is  now designed to run from a warm boot(ie  hitting  the 
  291.    reset button),to accomplish this place the file exactime.prg in  an 
  292.    auto folder followed by bootstar.prg and place the file bootstar.con
  293.    in the root directory of the drive with the auto folder. Enter the
  294.    pathname where you are keeping starv11.prg in textfile bootstar.con. 
  295.    This file as any file with the extension .txt can be edited with
  296.    First Word,MicroEmacs or any editor that will output a standard ascii
  297.    file.The system  will now  do  a warmboot when a carrier is lost while 
  298.    a user is  in  an outside  game  so the main program will always have 
  299.    to be  on  the system.
  300.  
  301.    Note pressing any key during reset will abort loading STar-Net!
  302.  
  303.     Run config.tos, to edit the system configuration.You can edit the
  304.    messages base access levels,message base name and the folder you
  305.    want the messages kept in, also the number of messages you want
  306.    to  be the maximum messages in that base (the messages  will  auto 
  307.    delete the low message when this number is exceded). You can enter 
  308.    a  user as a sub-op to the message base here as well. A sub-op has 
  309.    sysop abilities on his base alone. 
  310.    Do this for the UD section as well.Editing access levels: here you
  311.    can set the call time  limit and  the  limit  for calls  per day,
  312.    idle  timeout,and  that  access  level's  ability  to enter System 
  313.    Maint.(the dos and  user  editing area),news  maint. (the  ability  
  314.    to  add  edit  or  delete  news files), Outside maint (the ability
  315.     to add  edit  or  delete the  outside games  section, the  access  
  316.    levels  ability  to  send  E-Mail,Play Outside games, and read the 
  317.    user list. 
  318.  
  319.    In  the  edit other parameters you can change the enter  and  exit 
  320.    from  chat  strings,  change the baud detect  routine  from  hayes 
  321.    compatible  result codes to the hit return method.  You  can  also 
  322.    change the system log output from printer to a disk file, here you 
  323.    enter the default path,  the path for mail,  outside (this path is 
  324.    where you keep msh.prg,  all your outside games,  arc.ttp, and any 
  325.    files associated with the outside games).  You enter the text path 
  326.    here (this is where you keep the menus),  you can edit the  number 
  327.    of calls to the system.  You can change the system ID string which 
  328.    is  the  2 characters in front of the users ID  no.  that  creates 
  329.    there  ID ( currently set at SN you can make it ST or any other  2 
  330.    letter  combo that goes with your BBS theme).  You also enter  the 
  331.    new  users  starting points(this will be  incorporated  in  future 
  332.    outside games). 
  333.  
  334.  
  335.  
  336.  
  337.    Access levels for UD sections and message bases range from 0 to 15 
  338.    to make a section inaccessable enter a 16 for the access level.
  339.  
  340.    The files user.dat and user.ver should be kept in the folder
  341.    that you entered in the configuration program as the default path.
  342.  
  343.    The Hayes  baud  rate detect routine currently  uses  the  numeric 
  344.    result  code so if you are using the Avetec 1200 you will have  to 
  345.    use the non Hayes hit return method for detection. 
  346.  
  347.  
  348.    Function  keys  commands when a user is on line while you  are  in 
  349.    local mode are as follows:  F1 shows you the stats of the user  on 
  350.    line,  F3 brings you to system maint.  (this is the first step  to 
  351.    raising your own access level)with this entry  into system  maint. 
  352.    the  user  will be able to see and perform available  funtions  in 
  353.    system maint. as well. F4 toggles input,output to the modem on and 
  354.    off,  so  you  can  do things while users on line  and  hide  your 
  355.    actions.  F5  brings you directly into system  maint.  with  modem 
  356.    input  output disabled.  F10 is the engage and  disengage  chat.F2 
  357.    will disable the status window for user online information so  you 
  358.    can have a full screen in local mode.
  359.  
  360.    F1 in chat mode will allow you to add time to the current user.
  361.  
  362.    All menus,  the welcome.txt,  logon.txt, logoff.txt, and all files 
  363.    for  the general files area are to be kept in the  folder  entered 
  364.    for text path.The file newuser.txt has been added it is a  welcome 
  365.    message for new users and should be kept in the same folder.
  366.  
  367.  
  368.    Outside function:
  369.  
  370.    In order for the outside function and the View arc file function to 
  371.    work you  must have the file msh.prg in the directory  entered  as 
  372.    your outside path.
  373.    You must have ARC.TTP in the outside folder as well.
  374.    Note: Programs run from outside should no longer need to provide 
  375.    there own carrier detect!
  376.  
  377.    Pausing and aborting:
  378.  
  379.    You  can pause and abort all file reads and system  messages  with 
  380.    the command below.
  381.    The Control S pause, Control Q resume and control C abort. 
  382.  
  383.  
  384.  
  385.  
  386.  
  387.    The userlog record size has been expanded to hold more information if
  388.    you are running a lower version than .09 you must run userconv.tos in
  389.    the same folder as the files user.ver and user.dat,it will generate 
  390.    2 new files called new.ver and new.dat.Those files are replacements 
  391.    for user.dat and user.ver rename them as such and discard the old 
  392.    files(or keep themon a seperate disk until you have tested ver .09
  393.    just to be safe) the RN command has been added to the message bases
  394.    this will read new messages (skipping messages read with this 
  395.    version any messages read before this version were not stored in 
  396.    the users record).A BBS list updateable by validated users has 
  397.    been added.
  398.  
  399.  
  400.    modemcom.txt
  401.     Keep in same folder as logon.txt.This file holds the commands to 
  402.    alter your modems setup.The old commands built into the program are 
  403.    now in this file.
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.    System Variables
  440.    ----------------
  441.  
  442.    When reading a file if these strings are in the file they will be 
  443.    replaced with their respected variables.
  444.  
  445.  
  446.    Command string                              Output result
  447.    --------------------------------------------------------------------------
  448.    ~v0                             The Current Number of calls to
  449.                                   the BBS.
  450.  
  451.    ~v1                             The Handle of the Current user
  452.  
  453.    ~v2                             Users last call date
  454.  
  455.    ~v3                             Users last call time
  456.  
  457.    ~v4                             Last callers handle
  458.  
  459.    ~v5                             Current users real name
  460.  
  461.    ~v6                             Users Telephone number
  462.  
  463.    ~v7                             Users Download byte count
  464.  
  465.    ~v8                             Users Upload byte count
  466.  
  467.    ~v9                             Number of calls user has made
  468.  
  469.    ~va   (note lower case)              Current time
  470.  
  471.    ~vb                             Current date
  472.  
  473.    ~vc                             A prompt to press return
  474.  
  475.    The file logon.txt has an example of how to use the system variables in a
  476.    message.
  477.  
  478.  
  479.    Other notes
  480.    -----------
  481.  
  482.    Entering a 'a' at the ENTER RETURN prompt will abort the reading of 
  483.    welcome.txt.When reading messages the C for continue is no longer needed
  484.    pressing return will read the next message.
  485.  
  486.  
  487.    Deleting  a user:  To delete a user go to system maint.  and  type 
  488.    deuser,  you  will then be prompted for the user name of the  user 
  489.    you wish to delete or you can use the edit user function and choose
  490.    the delete option. 
  491.  
  492.  
  493.    Reading the Log: To read the system log if it is on disk type log, 
  494.    the file will then be displayed on your screen,  when the file  is 
  495.    finished  reading  you will be prompted for whether  you  wish  to 
  496.    delete  the  file  or  not.  Entering a y  will  delete  the  file 
  497.    otherwise it defaults to no.
  498.  
  499.  
  500.    Editing a text file: 
  501.    You  can edit a text file with a program such as  first  word,  or 
  502.    from  the BBS with the command edit from the system  maint.  area. 
  503.    The  file should be under 200 lines long if editing from the  BBS. 
  504.    Do not enter an editor command(i.e.  .l .s ect.)on the first line. 
  505.    If you wish to view the current file hit return first then you can 
  506.    use any editor commands. 
  507.  
  508.  
  509.    The UD file descriptions: 
  510.    These  files are normal text files and can be edited  as  above.In 
  511.    order  to  add a file description use the A command  from  the  UD 
  512.    section menu
  513.  
  514.    Updates:
  515.    You can now set a time for the system to shut down and come back up from
  516.    the config.tos program.When the BBS shuts down it will try to run a program
  517.    called shell.prg,this could be any command shell with an autolog.bat type
  518.    file that can exit when the batch file is run.This is not needed for the BBS
  519.    to operate but may be needed for online games that require daily updating.
  520.  
  521.  
  522.    You can now delete users from the user edit menu as well as with the deuser
  523.    command.You can search for users to edit by username,user id number,or 
  524.    access level(usefull for finding new users).
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.    VT52 graphics:
  548.    The files welcome.txt,logon.txt,logoff.txt,newuser.txt,and all of the
  549.    menus now have counterparts for VT52 graphic files with the same name
  550.    but with a .gra extension(welcome.txt welcome.gra).If a user answers
  551.    yes to the VT52 graphic prompt the BBS will try to read the file names
  552.    with the .gra extensions first if they cannot be opened the original
  553.    .txt file will be read.
  554.    
  555.    Changes Version 1.21
  556.  
  557.    8/31/87
  558.    Exactime.prg is no longer needed to maintain the time after a reset.You 
  559.    can also set the time from the waiting for call screen with F4.You must
  560.    use 24hr format for time(00:00= 12:00 midnight, 23:59= 11:59 P.M.).You
  561.    can now set the BBS to shut down during hours when the system should
  562.    be down(for part time BBS's) this is available through the config.tos
  563.    , option m from the edit other system parameters menu.This Toggles
  564.    part time BBS on and off and allows you to set the times to go up and
  565.    down.
  566.  
  567.    Eric Drewry
  568.    15 Greenlawn Ave.
  569.    South Grafton Ma. 01560
  570.    617-839-5810 online 8pm-9am otherwise call voice.
  571.  
  572.